<?php

/**
 * This code was generated by
 * \ / _    _  _|   _  _
 * | (_)\/(_)(_|\/| |(/_  v1.0.0
 * /       /
 */

namespace Twilio\Rest\Voice\V1\VoicePermission;

use Twilio\Exceptions\TwilioException;
use Twilio\InstanceResource;
use Twilio\Values;
use Twilio\Version;

/**
 * PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
 *
 * @property string isoCode
 * @property string name
 * @property string continent
 * @property string countryCodes
 * @property boolean lowRiskNumbersEnabled
 * @property boolean highRiskSpecialNumbersEnabled
 * @property boolean highRiskTollfraudNumbersEnabled
 * @property string url
 * @property array links
 */
class CountryInstance extends InstanceResource {
	protected $_highriskSpecialPrefixes = null;

	/**
	 * Initialize the CountryInstance
	 *
	 * @param \Twilio\Version $version Version that contains the resource
	 * @param mixed[] $payload The response payload
	 * @param string $isoCode The ISO country code
	 *
	 * @return \Twilio\Rest\Voice\V1\VoicePermission\CountryInstance
	 */
	public function __construct( Version $version, array $payload, $isoCode = null ) {
		parent::__construct( $version );

		// Marshaled Properties
		$this->properties = array(
			'isoCode'                         => Values::array_get( $payload, 'iso_code' ),
			'name'                            => Values::array_get( $payload, 'name' ),
			'continent'                       => Values::array_get( $payload, 'continent' ),
			'countryCodes'                    => Values::array_get( $payload, 'country_codes' ),
			'lowRiskNumbersEnabled'           => Values::array_get( $payload, 'low_risk_numbers_enabled' ),
			'highRiskSpecialNumbersEnabled'   => Values::array_get( $payload, 'high_risk_special_numbers_enabled' ),
			'highRiskTollfraudNumbersEnabled' => Values::array_get( $payload, 'high_risk_tollfraud_numbers_enabled' ),
			'url'                             => Values::array_get( $payload, 'url' ),
			'links'                           => Values::array_get( $payload, 'links' ),
		);

		$this->solution = array( 'isoCode' => $isoCode ?: $this->properties['isoCode'], );
	}

	/**
	 * Fetch a CountryInstance
	 *
	 * @return CountryInstance Fetched CountryInstance
	 * @throws TwilioException When an HTTP error occurs.
	 */
	public function fetch() {
		return $this->proxy()->fetch();
	}

	/**
	 * Generate an instance context for the instance, the context is capable of
	 * performing various actions.  All instance actions are proxied to the context
	 *
	 * @return \Twilio\Rest\Voice\V1\VoicePermission\CountryContext Context for
	 *                                                              this
	 *                                                              CountryInstance
	 */
	protected function proxy() {
		if ( ! $this->context ) {
			$this->context = new CountryContext( $this->version, $this->solution['isoCode'] );
		}

		return $this->context;
	}

	/**
	 * Magic getter to access properties
	 *
	 * @param string $name Property to access
	 *
	 * @return mixed The requested property
	 * @throws TwilioException For unknown properties
	 */
	public function __get( $name ) {
		if ( array_key_exists( $name, $this->properties ) ) {
			return $this->properties[ $name ];
		}

		if ( property_exists( $this, '_' . $name ) ) {
			$method = 'get' . ucfirst( $name );

			return $this->$method();
		}

		throw new TwilioException( 'Unknown property: ' . $name );
	}

	/**
	 * Provide a friendly representation
	 *
	 * @return string Machine friendly representation
	 */
	public function __toString() {
		$context = array();
		foreach ( $this->solution as $key => $value ) {
			$context[] = "$key=$value";
		}

		return '[Twilio.Voice.V1.CountryInstance ' . implode( ' ', $context ) . ']';
	}

	/**
	 * Access the highriskSpecialPrefixes
	 *
	 * @return \Twilio\Rest\Voice\V1\VoicePermission\Country\HighriskSpecialPrefixList
	 */
	protected function getHighriskSpecialPrefixes() {
		return $this->proxy()->highriskSpecialPrefixes;
	}
}